home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-21 / qwhite.zip / APISTART.TEC < prev    next >
Text File  |  1992-03-09  |  3KB  |  72 lines
  1. ID:AP Starting DESQview Under API
  2. Quarterdeck Technical Note #135
  3. by Stan Young
  4. last revision:  2 March 1992
  5.  
  6.                  Starting DESQview Under API Program Control
  7.  
  8. Many API programs are designed to run much the same as any off-the-shelf 
  9. program in the DESQview environment.  That is, the user simply selects them 
  10. from the Open Window menu, they open and once they are running they may begin 
  11. to control and take advantage of DESQview.
  12.  
  13. Creating an "auto-start" macro for DESQview can allow the program to be 
  14. brought up automatically on the start of DESQview.  The "auto-start" macro is 
  15. described in the DESQview users manual (Look up "Scripts, startup" and 
  16. "Scripts, global in the index).
  17.  
  18. The auto-start macro is generally a good starting method where you want to 
  19. make sure your API program is run, but want to make most of the features of 
  20. DESQview available to your users.  The default for starting in this method is 
  21. that all of the features of DESQview are enabled and your API program would 
  22. have to disable them specifically after starting up if you did not want all of 
  23. these features available.
  24.  
  25. However, sometimes API developers want to control the system more fully.  To 
  26. do this, you can start DESQview as follows:
  27.  
  28. DV {program information filename}
  29.  
  30. An example of a program started in this fashion is on every users DESQview 
  31. disk in the SETUP.BAT file.  It reads as follows:
  32.  
  33. DV SETUP.DVP
  34.  
  35. There are some other parameters listed in SETUP.BAT that are specific to 
  36. DESQview operation, but these would not normally become a part of your API 
  37. program startup (/OK assumes "non-enhanced keyboard", /NS means don't read the 
  38. setup file, use defaults.)
  39.  
  40. Run the DESQview Setup and you will get an idea of the defaults under which 
  41. API programs started from the command line are run:
  42.  
  43.      1.  After display of the DESQview copyright screen, the application 
  44.      listed in the DVP file is automatically run.
  45.  
  46.      2.  All access to the DESQview menu is disabled.  DESQview macros, 
  47.      including the auto-start macro for the window are enabled if present, but 
  48.      access to the Learn menu is not available.
  49.  
  50.      3.  Terminating the application terminates DESQview and drops you out to 
  51.      the DOS prompt.
  52.  
  53. Obviously, this is a limited, single-tasking environment, however this puts 
  54. the API program in control.  Once started, the API program can start 
  55. additional tasks (NEW or NEWPROC in assembler, app_new or app_start in C or 
  56. Pascal), and selectively enable the features of DESQview (Manager streams 00 
  57. to 3F in Assembler, or win_allow function in C or Pascal).  
  58.  
  59. The only feature not enabled is the Open Window item.  When an API program is 
  60. started from the command line, the DESQVIEW.DVO file,(contents of the Open 
  61. Window menu) is not read in and the Open Window option will not be present.  
  62. Your API program can produce its own menu of programs to open if you like.  If 
  63. you want to allow users to have access to the Open Window menu, you would want 
  64. to start up using the auto-start macro.
  65.  
  66.  
  67.   ************************************************************************
  68.   *This technical note may be copied and distributed freely as long as it*
  69.   *is distributed in its entirety and it is not distributed for profit.  *
  70.   *        Copyright (C) 1989-92 by Quarterdeck Office Systems           *
  71.   ************************ E N D   O F   F I L E *************************
  72.